home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / celeb22.zip / SYSOP.DOC < prev   
Text File  |  1993-05-02  |  19KB  |  467 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             CELEBRITY TRIVIA
  11.                               SYSOP'S MANUAL
  12.  
  13.                                  v2.2
  14.  
  15.                               May 1, 1993
  16.                          PCBoard 14.x and GAP 4.x
  17.                            WILDCAT!, SPITFIRE
  18.                              QBBS, RBBS, RA
  19.                                   WWIV
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.  
  25.                           The Parole Board BBS
  26.  
  27.                (919) 965-4696 ->US Robotics Dual Standard
  28.                           (919) 965-9885 ->FAX
  29.  
  30.                             Free Advice BBS
  31.  
  32.                         (919) 934-1002 - Node 1
  33.  
  34.                      US Robotics HST 14.4k / V42bis
  35.  
  36.                            -=-=-=-=-=-=-=-=-
  37.  
  38.                                 OVERVIEW
  39.                                 ________
  40.  
  41.  
  42. CONGRATULATIONS!  You and your users will find this Trivia door
  43. entertaining and educational.  It consists of approximately 100 or
  44. so questions that were carefully selected for your entertainment.
  45. The door displays a "Trivia Royalty" bulletin to the caller while
  46. it creates bulletins and logs for your use.  Best of all..this door
  47. is not crippleware.  It isn't full of advertisements and
  48. limitations...best of all I don't charge an arm and a leg.  You'll
  49. also find we are responsive to your questions.  If you need help or
  50. have a suggestion for improving this product, let me know!
  51.                      FILES AND DESCRIPTIONS
  52.                      ______________________
  53.  
  54. The archive includes the following files:
  55.  
  56.      CELEBTRV.EXE    -- The main executable file
  57.      SAMPLE.CFG     -- The sample configuration file
  58.      CELEBTRV.DAT  -- The main trivia data file
  59.      CELEB.HIS     -- Release History and changes
  60.      SCREENS.ZIP    -- Screens for the CELEBTRV\SCREENS sub directory
  61.          ^┌──WELCOME.ANS  -- The program color Welcome Screen,
  62.          ││                  (Can be modified by Sysop).
  63.          ││  WELCOME.ASC  -- The program mono Welcome Screen
  64.          └┤                  (Can be modified by Sysop).
  65.           │  GAMEPLAY.ANS -- ANSI Game screen ─┐ DO NOT Modify!
  66.           │  GAMEPLAY.ASC -- ASCii Game Screen─┘
  67.           │  INSTRUCT.ANS -- The color user instruction file
  68.           └──INSTRUCT.ASC -- The mono user instruction file
  69.      SYSOP.DOC    -- The installation instructions...(this file)
  70.      QUIKUP.DOC   -- Quick and Dirty installation instructions.
  71.      REGISTER.TXT -- Information and registration form...This will
  72.                      give you a personalized door, voice or bbs   
  73.                      support services, new issues of master.dat   
  74.                      files, a clear conscience and a still poor but
  75.                      happy door programmer.
  76.      SAMPLE.BAT      Sample door batch file
  77.      
  78. This ZIP file was created using the -AV function of PKZIP.  If my
  79. AV is missing then this file may not be complete or has been
  80. tampered with.  Complete and current editions of this program are
  81. always available for D/L on The Parole Board BBS.  If the AV is
  82. missing please complain to your sysop to stop the practice of
  83. removing AV's as this is your assurance from the programmer that
  84. the file is complete and virus free.
  85.  
  86.  
  87.                               INSTALLATION
  88.                               ____________
  89.  
  90.    Installation is quite simple and straight-forward. Follow these
  91. steps and example and you should be up and running in a matter of
  92. minutes.  Although CELEBTRV is an easy program to install on most any
  93. BBS, there may be some Sysop who has trouble.  Support is available
  94. in those situations.
  95.  
  96.  
  97.       1) Create a directory to hold all CELEBTRV files
  98.  
  99.       2) Unzip CELEBxx.ZIP into the above directory
  100.  
  101.       3) Run INSTALL.BAT
  102.  
  103.       4) Create a configuration file, with a name of your choice
  104.          or modify the SAMPLE.CFG file which is enclosed.
  105.  
  106.       5) Create a door batch file or use the sample enclosed.
  107.  
  108.  
  109.       6) Modify your particular BBS System Menus to add the
  110.          door.  The BBS setup various depending on the type BBS   
  111.          software you are running.  We assumed you are familiar   
  112.          with the general DOOR setup on your system.  Therefore our
  113.          description includes only examples of the CELEBTRV specific
  114.          configuration file and door batch file.  Refer to your
  115.          BBS documentation for door installation on your
  116.          particular software.
  117.  
  118.  
  119.  
  120. BBS USER FILES
  121.  
  122.      The BBS user file provides information to CELEBTRV!!, such as COM
  123.      port, user name, time allowed in the door, etc.  This file is
  124.      necessary for CELEBTRV to function.  The complete path\filename of
  125.      the BBS user file must be passed to CELEBTRV.EXE as the 1st
  126.      parameter in the command line.  The user file is created by
  127.      your BBS EACH time a user runs a door....The BBS USER file has
  128.      a different name on each type of BBS.  When you create your
  129.      CELEBTRV configuration file, you must tell CELEBTRV the name for your
  130.      particular BBS system.
  131.   
  132.      The following is a list of the user files used by the        
  133.      BBS types we support (we included a typical path).
  134.  
  135. drive\dir\filename
  136.    C:\WILDCAT\CALLINFO.BBS              ──┐  <- For Wildcat!
  137.    C:\WC30\WCWORK\NODE1\USERINFO.DAT      │  <- For Wildcat! 3.x
  138.    C:\PCB\PCBOARD.SYS                     │  <- For PCBoard using PCBOARD.SYS
  139.                                           │     only
  140.    C:\PCB\USERS                           │  <- For PCBoard using USERS only
  141.    C:\BBS\DOOR.SYS                        │  <- For Systems which support
  142.                                           │     DOOR.SYS
  143.    C:\BBS\DORINFOx.DEF                    │  <- For QBBS/RBB/RA.  Replace x
  144.                                           │     with Node#.
  145.    C:\BBS\SFDOORS.DAT                     │  <- For Spitfire
  146.    C:\BBS\CHAIN.TXT                    ───┘  <- For WWIV
  147.  
  148.  
  149. CONFIGURATION FILE
  150.  
  151. One (and only ONE) of the above will be LINE 1 of your
  152. configuration file. You MUST specify the path and name (including
  153. any extension) correctly if you expect CELEBTRV to find it.  Sample for
  154. Lines 2 through 10 are:
  155.  
  156.    The Parole Board BBS         <- Your BBS Name
  157.    Dennis                       <- SysOp's First Name
  158.    Maidon                       <- SysOp's Last Name
  159.    00000                        <- Registration Number
  160.    100                          <- Minimum security level allowed 
  161.                                    in door.
  162.    35                           <- Maximum questions allowed per visit
  163.                                    to the door.
  164.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  165.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  166.    WC                           <- WC Create WC!3.x specific bulls
  167.                                    PCB Create PCBoard specific bulls
  168.                                    Blank for ANSI & ASCii
  169.    2                            <- Number of times allowed to play door
  170.                                    each day.
  171.    RIP                          <- "RIP = create RIP bulls
  172.                                    "N" = do not create RIP bulls
  173.  
  174.  
  175.      Edit the Sample.CFG file to suit your individual BBS.  You
  176. must have all 11 lines and no extra characters.
  177.  
  178.   Line 1:  This line points to where CELEBTRV.EXE will find the callers
  179.            information file.  Just include the line that your     
  180.            particular BBS uses.  DO NOT put all of them in the CFG 
  181.            file.
  182.  
  183.    Line 2:  Place the name of your BBS on this line.
  184.  
  185.    Line 3:  SysOp's first name goes here.
  186.  
  187.    Line 4:  SysOp's last name goes here.
  188.  
  189.    Line 5:  Your Registration Number goes here if registered.  If
  190.             you haven't registered you can still use the          
  191.             door...just enter 00000 until you get your registration 
  192.             number.
  193.  
  194.    Line 6:  The minimum security level that is allowed in the door.
  195.  
  196.    Line 7:  Maximum number of questions allowed per visit to the door.
  197.             I would suggest 25-30 as a reasonable number.  The smaller
  198.             this number, the more likely that the users will continue to
  199.             use the door.
  200.  
  201.    Line 8:  Enter the complete path and name of the ANSI bulletin
  202.             that you want CELEBTRV to create.
  203.  
  204.    Line 9:  Enter the complete path and name of the ASCii bulletin
  205.             that  you want CELEBTRV to create.
  206.  
  207.    Line 10:  "WC" to create WC!3.x specific bulletins or NO for ANSI and
  208.              ASCii bulletins. "PCB" on this line will enable the program
  209.              to create PCBoard specific color bulletins.  If you Config
  210.              for WC! or PCB bulletins, Place the name of the bulletin
  211.              on Line 8 of the CFG file.  Be sure to add the ".BBS"
  212.              extension to it.  You may leave Line 9 blank but it still
  213.              MUST be included in the CFG file.
  214.  
  215.    Line 11:  Number of times users may play the door each day
  216.  
  217.    Line 12: Place "RIP" on this line to enable the creation of RIP
  218.             graphic bulletins.  "N" disables
  219.  
  220.  
  221.          If you use the sample CFG file be sure to remove all
  222. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  223. processors typically leave hidden control codes. Those hidden codes
  224. could cause the program to depart for worlds unknown.  Save your
  225. newly edited file using any name you want....suggested CELEBTRV.CFG.
  226.  
  227.  
  228.  
  229.  
  230.  
  231. DOOR BATCH FILE
  232.  
  233.          Create a batch file or modify the sample CELEBTRV.BAT file
  234.          supplied. This is what you need:
  235.  
  236.   @ECHO OFF
  237.   CLS                   Keeps a clean screen (optional)
  238.   CD \DOORS\CELEBTRV      Change to the CELEBTRV door files directory
  239.   CELEBTRV CELEBTRV.CFG    Run CELEBTRV using CELEBTRV.CFG configuration
  240.                           Change back to the WCAT BBS directory
  241.                           Restart the BBS.  On BBSs which shell to
  242.                           dos to run the door this line may be    
  243.                           omitted or maybe the word "EXIT."  Check 
  244.                           your BBS door instructions.
  245.  
  246. The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
  247. of TERMINATE for doors.
  248.  
  249. MULTIPLE NODES
  250.  
  251.         Create a configuration file for each node.  Each file     
  252.         should have a unique name.  
  253.  
  254.         EX: CELEB1.CFG  CELEB2.CFG
  255.  
  256.         CELEBTRV has been tested under LIVECAT and DESQVIEW and performs
  257.         very well under either or both.
  258.  
  259.  
  260. COMM PORT IRQs
  261.  
  262. CELEBTRV is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  263. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  264. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  265. IRQ  number after the configuration filename. Let's assume your
  266. Door is called FOOBAR and you want to use COM1 but non-standard
  267. IRQ5. The command line  passed to your Door would be:
  268.  
  269.         FOOBAR FOOBAR.CFG /5
  270.  
  271.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  272. IRQ4 normally used with COM1. No /x parameter is needed for the
  273. standard IRQ's.
  274.  
  275. Fossil Driver Support
  276. ---------------------
  277. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  278. Fossil driver instead of the standard COM ports, just put /FD on the command
  279. line when running the door. For example:
  280.  
  281.      MYDOOR MYDOOR.CFG /FD
  282.      MYDOOR MYDOOR.CFG *FD
  283.  
  284. indicates that a Fossil driver is present and should be used. If no Fossil
  285. driver is detected, DoorFrame will print a message to that effect and exit
  286. the door gracefully.
  287.  
  288.  
  289. TIPS AND TRAPS
  290.  
  291.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  292. files if they are included in the package.  They sometimes contain
  293. some very useful information. <G>  
  294. Of course you can do like me, just set the darn thing up without
  295. the docs then fuss at the door author for not making it simple
  296. enough to work the first time.
  297.  
  298.       IF You get an error...check every path to make sure you typed
  299. it correctly.  Check the file name...does it match exactly?  Does
  300. the configuration filename match?  Did you leave off the
  301. configuration file extension?   Do you have the correct BRUN module
  302. in a directory on your path?  If all those seem correct and the
  303. door still won't work...call me......preferably not in the middle
  304. of the night...no door is that important.
  305.  
  306.       When the door is in use...you can use the sysop options
  307. listed at the bottom of your screen to chat, increase or decrease
  308. the users time or log the user off.
  309.  
  310. NOTE:  You may now use one (1) CFG file for multi-node by using the
  311. environment variables.
  312.  
  313. When specifying the location of the system file on line 1 of the doors .CFG
  314. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  315. and %wcnodeid%. Some examples:
  316.  PCBoard: 
  317.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  318.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  319.  
  320.  Wildcat!:
  321.    USERINFO.DAT in C:\WC30\WCWORK\NODE1   - C:\WC30\WCWORK\NODE%WCNODEID%
  322.  
  323. Non-PCBoard systems may use the PCB environment variables by setting them
  324. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  325.  SET PCBDRIVE=C:
  326.  SET PCBDIR=\BBSDIR
  327.  SET PCBNODE=1
  328.                              --------------
  329. Create the CFG file(s) for you particular BBS.  You will also need a DOORx.BAT
  330. to run the door.  This one is simple.
  331.  
  332. @ECHO OFF
  333. CD \DOOR\CelebTrv
  334. CelebTrv BBS.CFG /5
  335.               ──┬─
  336.  ┌──────────────┘
  337.  └ If you are running non-Standard Com ports on your BBS, you will need to pass
  338.  the proper IRQ to the door.  It doesn't hurt to pass the IRQ even if they are
  339.  standard.  If a user enters the door and it just sits there acting sort of
  340.  stupid, it's probably looking for the correct IRQ.  Always pass it on the
  341.  command line and there will be no question.  Some networks have a problem
  342.  using the "/" symbol.  CelebTrv will now accept an asterisk "*" in place of
  343.  the "/".  You may also use the environment variable in the DOORx.BAT file to
  344.  pass info to the door.
  345.  
  346. CelebTrv BBS%WCNODEID%.CFG /%WCIRQID%
  347.  
  348. Make sure you DO have the variables set if you use this method.
  349.  
  350. NOTE: CelebTrv supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  351.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  352.       number after the configuration filename. Let's assume your Door is
  353.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  354.       passed to your Door would be:
  355.  
  356.         FOOBAR FOOBAR.CFG /5
  357.         FOOBAR FOOBAR.CFG *5
  358.  
  359.       The /5 tells CelebTrv to use IRQ5 rather than the standard IRQ4 that
  360.       is normally used with COM1. No /x parameter is needed for the standard
  361.       IRQ's. CelebTrv supports IRQs 1 - 15.
  362.  
  363. Fossil Driver Support
  364. ---------------------
  365. CelebTrv supports the use of Fossil drivers.  To tell your Door to use the
  366. Fossil driver instead of the standard COM ports, just put /FD on the command
  367. line when running the door. For example:
  368.  
  369.      MYDOOR MYDOOR.CFG /FD
  370.      MYDOOR MYDOOR.CFG *FD
  371.  
  372. indicates that a Fossil driver is present and should be used. If no Fossil
  373. driver is detected, CelebTrv will print a message to that effect and exit
  374. the door gracefully.
  375.  
  376.  
  377.  
  378.  
  379.                                 MISCELLANEOUS NOTES
  380.                                 ===================
  381.  
  382. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  383.  
  384. When using PCBOARD.SYS, CELEBTRV requires that PCBOARD.DAT be in the same
  385. directory as PCBOARD.SYS. CELEBTRV also accesses the USERS file.
  386.  
  387. When using USERS.SYS, CELEBTRV also accesses PCBOARD.SYS, PCBOARD.DAT and the
  388. USERS file.
  389.  
  390. The DOOR.SYS used by CELEBTRV is the standard 52 line GAP (tm) file.
  391.  
  392. The CALLINFO.BBS used by CELEBTRV currently contains 36 lines.
  393.  
  394. DoorFrame doors may now make use of the IRQ environment variable. For
  395. example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
  396. (I use this method here on The Parole Board for WC! and it works just
  397. fine.  Use "/%WCIRQID%".)
  398.  
  399. DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
  400. %PCBDIR%. If it finds those two variables on the first line of the .CFG
  401. file it will substitute the correct drive and path.
  402.  
  403.  
  404.  
  405.                               LEGALITIES
  406.                               __________
  407.  
  408.  
  409.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  410. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  411. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  412. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  413. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  414. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  415. USE THEREOF OR BREACH OF ANY WARRANTY.
  416.  
  417.  
  418.                              DISTRIBUTION
  419.                              ____________
  420.  
  421.    You may make this file available for downloading from your BBS
  422. or you may  upload it to any BBS of your choice, provided that you
  423. do not make any  changes to the contents of the archive (ZIP file).
  424. The archive and its  individual contents may not be used by any
  425. service that charges any money whatsoever, without the written
  426. permission of the author.
  427.  
  428.                              REGISTRATION
  429.                              ____________
  430.  
  431.    I am not a subscriber to the "Crippleware" concept, and this
  432. program  reflects that philosophy. This is a full-featured program,
  433. whose functionality is not hampered in any way, whether you
  434. register it or not.  It is only $15 to register this door.  Registered
  435. SysOps will receive an added utility that will allow you to edit and/or
  436. add questions to the database.
  437.  
  438.    Remember, whether you are registered or not, should you have any
  439. problems, questions or suggestions for improvements, be sure to
  440. drop me a message on either of the aforementioned BBS or via the
  441. DOORS or SYSOP conference on RIME(tm), Node ID = PAROLE.
  442.  
  443.  
  444.                                  THANKS
  445.                              --------------
  446.  
  447.     Special thanks goes out for my wife who is definitely a
  448.     "Computer Widow".
  449.  
  450.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  451.     Development Library.
  452.  
  453.     My BBS users who have had to endure constant badgering to help 
  454.     me test the programs that I have written.
  455.  
  456.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  457.     greatest BBS Software on the market, WILDCAT! 3.x.  And about 
  458.     to be even better when they revamp the on-line chat feature.
  459.  
  460.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  461.     Liane, you wouldn't have these fine DOCs.
  462.  
  463.     Ned Attayek, SysOp, Free Advice BBS in Smithfield, NC for his
  464.     tireless effort in coming up with all these questions.  This door
  465.     would never have been possible without his diligence.
  466.  
  467.